home *** CD-ROM | disk | FTP | other *** search
/ By Popular Request 2.0 / By Popular Request 2.0 (Arsenal Computer).ISO / amiga_6 / tcphl110.lha / AMITCPHE.10 / DOCSV1.10 < prev    next >
Text File  |  1995-04-11  |  14KB  |  373 lines
  1.  
  2.                                        ####..............  .....   ............
  3.     #########                         ###.############# ..#####. .############..
  4.     #########                         ###.#  -######## .#######. .#  -##########.
  5.     #########                         ###.# -######## .##  -###. .# -############.
  6.    ###########                         ##.#-######## .## ####### .#-#############.
  7.    ###########                           .########## .# -####### .######...#######.
  8.    ###########    #####  ##### ####   ####....##### .##-#####... .######.  .######.
  9.   #############   ##################  #####  .##### .#######.    .######.  .#-####.
  10.   ###### ######   ################### #####  .##### .######.     .######...## ####.
  11.   ###### ######   ################### #####  .##### .######.     .#########- -###.
  12.  ####### #######  #####  #####  ##### #####  .##### .######.     .########- #####.
  13.  ######   ######  #####  #####  ##### #####  .##### .######.     .##############.
  14.  ######   ######  #####  #####  ##### #####  .##### .#######.    .############..
  15. ################# #####  #####  ##### #####  .##### .########... .######......
  16. ################# #####  #####  ##### #####  .###### .########## .######.
  17. ################# #####  #####  ##### #####  .###### .########## .######.
  18. ################# #####  #####  ##### #####  .######. .########. .######.
  19. ######     ###### #####  #####  ##### #####  .######.  .#######. .######.
  20. ######     ###### #####  #####  ##### #####  .######.   ..#####. .######.
  21.                                                ......      ......  ......
  22.  
  23.  
  24.  
  25.                                         #    #       #
  26.                                         #    #       #
  27.                                         #    #  ###  # # ##   ###  # ##
  28.                                         ###### #   # # ##  # #   # ##
  29.                                #####    #    # ##### # #   # ##### #       #####
  30.                                         #    # #     # #   # #     #
  31.                                         #    # #   # # ##  # #   # #
  32.                                         #    #  ###  # # ##   ###  #
  33.                                                        #
  34.                                                        #
  35.                          - Version 1.10 11.IV.95 -
  36.                                By Ben Vost
  37.  
  38.  
  39.  
  40. This is just a little gizmo to work with the Demon AmiTCP
  41. installation. It possibly won't cope with any other AmiTCP setup but
  42. you can try. To start with it needs a script called "startnet" in
  43. Amitcp:bin/. You can set the tooltypes to reflect the programs you
  44. want to use for linking, ftp, mail, news, etc.
  45.  
  46. It was written using a mixture of CanDo 2.0 and 3.0 and requires the
  47. supplied cando.library (in libs:). Sorry about the *enormous* ASCII
  48. Art logo, but I just got Photogenics and I wanted to try it out. :)
  49.  
  50. Unfortunately, any errors in location or setup just result in the
  51. program not running at all, with no explanation for what went wrong.
  52. Make sure that you have Rexxc in your path, or copy the "RX" program
  53. from Rexxc into C:.
  54.  
  55.  
  56. Requirements
  57. ------------
  58.  
  59. As far as I know it should run on any Amiga with an AmiTCP
  60. installation (and possibly a Demon account :)). I have tested on an
  61. Amiga 3000 and 3000T running WB3.1 and also an A4000/040 running
  62. WB3.0. I don't think that there is a reason why it shouldn't run on
  63. an earlier operating system, but you do need ARexx. To use the
  64. GetNews button you must have the script "NNTPTransfer" in AmiTCP:bin.
  65. The provided nntptransfer script has a couple of alterations to the
  66. one provided by DIS, namely paths for all the commands and an
  67. automatic retry if News is busy (thanks Tez (Tez@tezboyes.demon.co.uk)).
  68.  
  69.  
  70. Installation
  71. ------------
  72.  
  73. This part's really tricky so pay attention.
  74.  
  75. Copy AmiTCPHelper anywhere you like. :)
  76.  
  77. (Seriously, do check that the tooltypes agree with your set up and
  78. that the supplied nntptransfer script is in AmiTCP:bin.)
  79.  
  80.  
  81. Buttons
  82. -------
  83.  
  84. The buttons do what they say they do. If you have entered NONE for
  85. some of the tooltypes then AmiTCPHelper disables that button.
  86.  
  87. The Mail button changed in version 1.07 to account for multiple
  88. mailboxes. I'm afraid it's a bit unfriendly at the mo, but I hope to
  89. sort it out in versions to come. If you only have one mailbox, then
  90. you won't notice any changes, if you have more than one, however,
  91. then clicking on the Mail button will bring up a requester asking
  92. which mailbox you want to look at. Unfortunately, owing to CanDo not
  93. being able to put variables into a requester I can only get it to say
  94. "Box1", "Box2", etc. but now a key is given in the body of the
  95. requester.
  96.  
  97. Ping, Finger, Clock & now Telnet
  98. --------------------------------
  99.  
  100. Just type in the name of whoever you want to ping or finger and hit
  101. return. Clock works the same way and will save the resulting time.
  102. AmiTCPHelper will pop up a window with the relevant details. I have
  103. finally added Telnet to AmiTCPHelper, it's not that it was difficult
  104. to do, it's just that I never use it, so I didn't put it in. But then
  105. again, I hardly ever use Gopher, but I put that in, so there you go
  106. :■
  107.  
  108. Telnet works the same way that all the other field-based tools in
  109. AmiTCPHelper do, just type in where you want to go. You can include
  110. the port name as well.
  111.  
  112.  
  113. Newsgroups
  114. ----------
  115.  
  116. This window will list any newsgroup configs you have. You can
  117. double-click on an entry to make it the current "NewsGroups" file.
  118. Newsgroup files should be named "newsgroups.what_you_like" and put in
  119. where newsroups normally go, your Amitcp:usr/lib directory. This is
  120. where AmiTCPHelper will look for them. Your original newsgroups file
  121. is copied to AmiTCP: and then copied back to AmiTCP:usr/libs when you
  122. quit AmiTCPHelper. You might want to make a newsgroups.std list
  123. containing your standard config in case AmiTCPHelper accidentally
  124. overwrites your original newsgroups because your machine has crashed
  125. or something.
  126.  
  127.  
  128.  
  129.  
  130. Tooltypes and their meanings:
  131. -----------------------------
  132.  
  133. If you enter NONE for the tooltypes for FTP, Mail, Gopher, WWW, IRC or
  134. HList, then AmiTCPHelper will disable the appropriate button. (HList
  135. doesn't have a button but it won't be looked for when a web browser
  136. is loaded.)
  137.  
  138. WindowX        Gives the final x position of the AmiTCP helper on
  139.         the screen.
  140.  
  141. WindowY        Gives the final y position of the AmiTCP helper on
  142.         the screen.
  143.  
  144. DONOTWAIT    Standard commodity stuff if you want AmiTCPHelper in
  145.         your WBStartup drawer.
  146.  
  147. FTP        Put the path and name of your favourite FTP tool here.
  148.         Possibilities would include "AmiTCP:bin/mftp" or
  149.         "Comms:AmiTCP/ftp", etc. (No quotes are needed). I
  150.         have tested it with both of these and ncftp.
  151.  
  152. Mail        As for FTP. It has been tested with Mail and Elm.
  153.  
  154. WWW        As for FTP. Well, it's been tested with AMosaic, but
  155.         if there is a secret Netscape clone for the Amiga
  156.         that I could test it with, will someone PLEASE let me
  157.         know? :)
  158.  
  159. Gopher        As for FTP. Tested with Graham's AmigaGuide-based
  160.         Gopher.
  161.  
  162. News        This isn't currently working and will be removed
  163.         from v1.11 onwards until someone writes a newreader I
  164.         can call up with it.
  165.  
  166. AmiTCPhome    This is the home directory for AmiTCP. Make sure you
  167.         include    trailing "/" or ":", ie. "Data:AmiTCP/".
  168.  
  169. Editor        This is the editor you will run when editing your
  170.         config in the menus. Put the complete path and name
  171.         of the program. To be able to edit the files it says
  172.         it can they have to be in the AmiTCP:db and
  173.         AmiTCP:usr/lib directories. Tested with TurboText.
  174.  
  175. SMail        This is the sendmail command for AmiTCPHelper to use.
  176.         It must    reside in Amitcp:bin. Just enter the filename.
  177.  
  178. Link        This is your *ARexx* link script. AmiTCPHelper
  179.         automatically looks for this script in your
  180.         AmiTCPHome bin directory. Tested with "Link" and
  181.         phil's (phil@curve.demon.co.uk) "PLink".
  182.  
  183. LinkOpts    The options for linking up. You should at least give
  184.         "up" as an option, but you can also put "up news" or
  185.         any other commands that your link script supports.
  186.  
  187. HList        As for FTP. This is the Hotlist program for Mosaic.
  188.         There is only one as far as I know.
  189.  
  190. Ping        As for FTP. This is your Ping command.
  191.  
  192. Finger        As for FTP. This is the command you should use for
  193.         finger (oo-err).
  194.  
  195. Clock        As for FTP. This is the clock command you are going
  196.         to use. So far I have only tested it with Syncro.
  197.  
  198. IRC        As for FTP. Enter the name of your IRC client.
  199.         Remember to include the path. Tested with Grapevine.
  200.  
  201. Telnet        Your telnet application. It works with Telnet_VGOODER
  202.         from Demon and should work with most if not all of
  203.         the others.
  204.  
  205. Startnet    This tooltype determines whether you want the
  206.         startnet script executed by AmiTCPHelper or in your
  207.         user-startup. Enter yes for yes and no for no (quel
  208.         surprise!).
  209.  
  210. Menus:
  211. ------
  212.  
  213. Project Menu
  214.  
  215. About        This shows you what version of AmiTCPHelper you are
  216.         running and my name and email address. If you
  217.         register this is where your personalisation will
  218.         appear.
  219.  
  220. About CanDo    This gives some information about CanDo v3.
  221.  
  222. Quit        Surprisingly enough, this actually quits out of
  223.         AmiTCPHelper.
  224.  
  225.  
  226.  
  227. Edit Menu
  228.  
  229. Aliases        Hmm, God knows what this does...
  230.  
  231. Config        This lets you edit your AmiTCP:usr/lib/config file.
  232.         I'm not really sure if this is any use at all...
  233.  
  234. DialScript    Lets you edit that dialscript...
  235.  
  236.  
  237. NewsGroups    Surprise, surpise, surprise... This lets you edit your
  238.         newsgroups. Remember kiddies, the number after the
  239.         newsgroup is how many days to keep news for before it
  240.         gets trimmed.
  241.  
  242. NewsStamp    Lets you edit the newsstamp so you aren't on the
  243.         blower downloading all night... :)
  244.  
  245. Startnet    Lets you edit the startnet script. Changes made will
  246.         obviously not work until you re-run the startnet
  247.         script.
  248.  
  249. .signature    Duh, not sure really...
  250.  
  251.  
  252. To Do List:
  253. -----------
  254.  
  255. Sort out the default directory for downloading.
  256.  
  257. Amigaguide documentation. (Like it really needs it! :) )
  258.  
  259. Setting the ENV:sana2/slip0config, although I think that once it has
  260. been read once it takes no notice of any changes.
  261.  
  262. Sort out the Prefs page.
  263.  
  264. Add a newsgroups editor that grabs the new newsgroups list from
  265. nntptransfer, and also lets you browse an "active" list. Done! It's a
  266. separate program called GroupEditor, downloadable from an Aminet site
  267. near you (comm/tcp).
  268.  
  269. Not sure of anything else, really. Any suggestions?
  270.  
  271.  
  272. Legal Stuff:
  273. ------------
  274.  
  275.  
  276. Disclaimer
  277. ==========
  278.  
  279.    THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
  280. APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
  281. HOLDER AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT
  282. WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
  283. LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  284. A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND
  285. PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE
  286. DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR
  287. CORRECTION.
  288.  
  289.    IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
  290. WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY
  291. REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR
  292. DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL
  293. DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM
  294. (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED
  295. INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE
  296. OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH
  297. HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
  298. DAMAGES.
  299.  
  300.  
  301. AmiTCPHelper is not Public Domain and is ⌐ Ben Vost 1995. If you
  302. register with me for ú10, I will ensure that you receive all
  303. upgrades, until further notice, via EMail automatically. I can also
  304. configure AmiTCPHelper to your tastes, changing the Ping, Finger,
  305. Telnet and CLock default addresses, things like that. I can also
  306. reinstate the much nicer eight-colour buttons. If you do not have an
  307. EMail facility, I'm not sure what I will do (and why are you using my
  308. program?!), but contact me at the following address:
  309.  
  310. EMail:    Ben@subway.demon.co.uk
  311.  
  312. SMail:  Ben Vost
  313.     5c Market Place
  314.     Margate
  315.     Kent CT9 1ER
  316.  
  317. Tel:     01843 292458
  318.  
  319. My snail mail address will be changing very shortly...
  320.  
  321. History
  322. -------
  323.  
  324. v1.10    Added Telnet support (for completeness sake).
  325.     Added a new eight-colour (and four-colour) icon that freely
  326.     plagiarises the Xen style :)
  327.     More internal wrangling going on for the prefs page which
  328.     should be complete soon (maybe v1.12).
  329.     Added Startnet tooltype.
  330.  
  331. v1.09    Added startnet script editing in the Edit menu.
  332.     Added IRC and Prefs buttons to the interface which has been
  333.     jiggled to fit the new buttons in without requiring more
  334.     space. The Prefs button doesn't work at the mo, but will
  335.     eventually let you edit TCP-related ENV variables and the
  336.     co-ordinates and size of the windows that AmiTCPHelper opens
  337.     amongst other things.
  338.  
  339. v1.08    The Get News button now works! Hurrah!
  340.  
  341. v1.07    Changes made to the way Mail is dealt implemented in this
  342.     version.
  343.  
  344. v1.06    General tidying up.
  345.     Internal changes to the way mail is dealt with.
  346.  
  347.  
  348. v1.051    Changed the buttons to four colour ones for the Amiga
  349.     Computing Cover disk.
  350.  
  351. v1.05    Made Mail detach when run from AmiTCPHelper.
  352.     Added the Clock function.
  353.     Took out the sound samples, they were taking up far too much
  354.     space. If anyone wants them back, I can put them in just for
  355.     you.
  356.     Changed the About message and added the CanDo about.
  357.     Fiddled about with Get News, it's still not quite ready, but
  358.     hopefully the next release should see that button enabled.
  359.     (No promises... :) )
  360.  
  361. v1.04    Added support for multiple newsgroups.
  362.  
  363. v1.03    Changed the shape of the window to make it easier to use Ping
  364.     and Finger.
  365.     Miscellaneous internal tidying up.
  366.  
  367. v1.02    Added support for Ping and Finger.
  368.  
  369. v1.01     Added support for user definable link command and options.
  370.     Added better support for AMHotlist.
  371.     Added Info menu item.
  372.  
  373. v1.0     First public release